home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 2.iso / winsock / winsock.zip / INSTALL.TXT < prev    next >
Text File  |  1994-02-02  |  60KB  |  1,433 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                  Trumpet Winsock
  8.  
  9.  
  10.  
  11.                                    Version 1.0
  12.  
  13.  
  14.  
  15.                                 By Peter R. Tattam
  16.  
  17.  
  18.  
  19.                     Managed by Trumpet Software International
  20.  
  21.  
  22.  
  23.  
  24.                     Copyright (C) 1993,1994 by Peter R. Tattam
  25.  
  26.                                All Rights Reserved
  27.  
  28.  
  29.                                         2
  30.  
  31.  
  32.             Introduction
  33.  
  34.             Thank you for using  the Trumpet Winsock.   It is through
  35.             the kind  support of  many users  out there  that quality
  36.             networking software  has  been  available  at  affordable
  37.             prices to the Internet community. The  Trumpet Winsock is
  38.             a Windows  Sockets  1.1  compatible  TCP/IP  stack  which
  39.             provides a standard networking layer for many Windows(tm)
  40.             networking applications  to use,  and has  itself  been a
  41.             major vehicle  in  achieving  widespread  use of  Windows
  42.             Sockets 1.1.   The  product is  a shareware  item  and as
  43.             such, you are permitted to evaluate it for a period of 30
  44.             days.   If  you  are  satisfied  with its  usefulness,  a
  45.             registration form is provided which you  can fill out and
  46.             send to Trumpet  Software International.   A registration
  47.             fee is requested to maintain the  development and support
  48.             of this software.   Suitable arrangements  have been made
  49.             for site licenses,  and details can  be found in  a later
  50.             section.
  51.  
  52.             Disclaimer & Copyright
  53.  
  54.             These programs are  Copyright (C)  1991-1994 by  Peter R.
  55.             Tattam,
  56.             All Rights Reserved.
  57.  
  58.             They  are  provided  as  shareware   with  the  following
  59.             limitations:
  60.  
  61.                  These programs  are shareware  and are  not to  be
  62.                  resold or distributed for sale with other programs
  63.                  which are for sale.  There is no warranty or claim
  64.                  of  fitness  or  reliability.  The  programs   are
  65.                  distributed AS IS, and as such neither the author,
  66.                  nor  Trumpet   Software  International   nor   the
  67.                  University of Tasmania  shall be  held liable  for
  68.                  any loss of  data, down time,  loss of revenue  or
  69.                  any other  direct  or indirect  damage  or  claims
  70.                  caused by these programs.
  71.  
  72.             Instructions for Installing the Trumpet Winsock.
  73.  
  74.             The Trumpet Winsock  will only run  on your PC  under the
  75.             following conditions.  You  must  have  either  a  packet
  76.             driver available for use  by network programs,  or if you
  77.             wish to  use  SLIP, a  free  comms  port.   Additionally,
  78.             packet drivers can  only be used  reliably under enhanced
  79.             mode using WINPKT.   Standard mode can be  used, but care
  80.             must be taken to avoid system crashes.   NDIS and ODI can
  81.             be used via  packet driver  shims, but  their use  is not
  82.             supported.  PKTMUX  may also  be used instead  of WINPKT,
  83.             and must be version 1.2c  or later, but again  its use is
  84.             not supported.
  85.  
  86.             If you  already  have  some  kind  of  TCP/IP  networking
  87.             package installed,  it is  most likely  that  the Trumpet
  88.             Winsock will not  run and you  will have to  massage your
  89.             system configuration  to  install  the  Trumpet  Winsock,
  90.  
  91.  
  92.                                         3
  93.  
  94.  
  95.             possibly  even  to   the  extent  of   uninstalling  that
  96.             networking  package.    Alternatively,  there  may  be  a
  97.             Winsock available  for  your package  in  which case  the
  98.             Trumpet Winsock will not be required.
  99.  
  100.             Installing Trumpet Winsock over Packet Driver.
  101.  
  102.             Firstly, if you don't know what a packet driver is, it is
  103.             normally a small piece of software  which sits in between
  104.             your network card and  your TCP program.  This provides a
  105.             standard interface  which  many  programs  can  use in  a
  106.             similar manner to BIOS calls using software interrupts.
  107.  
  108.             Why is it called a packet driver?  This is because modern
  109.             networks send  information using  packets  of information
  110.             rather than sending information one byte  or character at
  111.             a time.    For  example,  Ethernet  sends information  in
  112.             frames of up to 1514 bytes long.   The reason for sending
  113.             things in packets is that information  can be transmitted
  114.             much more efficiently in packets.
  115.  
  116.             Central to the concept of the packet driver is the vector
  117.             which is used to  communicate with it.   The 80x86 family
  118.             of processors  allows  programs to  communicate  with the
  119.             operating system  through  what  is  called  a  "software
  120.             interrupt", which always has  a number in the  range 0 to
  121.             255.  This is termed a "vector" and is the one of the key
  122.             mechanisms  to  pass  control  to  the  MS-DOS  operating
  123.             system.  Usually  the vectors are  in hexadecimal, making
  124.             the range expressed as 0x00  to 0xFF. The 0x  in front of
  125.             the number means  that we  are using  hexadecimal numbers
  126.             instead of decimal numbers.   They may  also be expressed
  127.             in the notation  00H to FFH,  or $00  to $FF. If  you are
  128.             dealing with packet drivers, hexadecimal notation is much
  129.             more common,  but  occasionally  they  are  expressed  in
  130.             decimal.  Examples of software interrupts  in use on PC's
  131.             are 0x10 for the video BIOS, or 0x21 for calls to DOS.
  132.  
  133.             Packet drivers  are  only  allowed  to  have  a  software
  134.             interrupt vector in the range 0x60 to 0x7F. Normally, you
  135.             will pick  0x60  as the  default  place  to install  your
  136.             packet driver,  but  certain  machine configurations  may
  137.             make that  vector unavailable.  Just choose  one  that is
  138.             free - the packet driver  should tell you if  you can use
  139.             it or not.
  140.  
  141.             The Trumpet Winsock  also uses  a special  virtual packet
  142.             driver "wrapper"  which  enables  your  packet driver  to
  143.             function correctly in  Windows.  While  the packet driver
  144.             is an  efficient  way to  communicate  with your  network
  145.             card, it will not  work correctly from  Windows without a
  146.             little assistance.   The program "WINPKT"  was written by
  147.             some clever  people on  the  Internet to  allow  a packet
  148.             driver to work  correctly within  Windows by  making sure
  149.             that  packets  get  directed  to   the  correct  "virtual
  150.             machine"  under  Windows  enhanced  mode.     A  "virtual
  151.             machine" can be either the entire Windows session, or any
  152.  
  153.  
  154.                                         4
  155.  
  156.  
  157.             dos session active within Windows.   Refer to the Windows
  158.             system documentation for more details.
  159.  
  160.             In  addition  to  this,  you  will   need  to  have  some
  161.             understanding of IRQ  vectors and I/O  addresses that may
  162.             be relevant to installing your network card.
  163.  
  164.             Where do I obtain packet drivers from?
  165.  
  166.             These days, packet drivers are usually provided with your
  167.             network card,  but a  comprehensive collection  of public
  168.             domain packet driver can be obtained from a packet driver
  169.             collection called the "Crynwr  Packet Driver Collection."
  170.             Information on where to get this packet driver collection
  171.             from is provided as an appendix to this document.
  172.  
  173.             Actually Installing the Winsock.
  174.  
  175.             Before you  do  anything,  copy  the  files  winsock.dll,
  176.             tcpman.exe, winpkt.com, hosts, services and protocol to a
  177.             suitable directory.
  178.  
  179.               eg. c:\trumpet
  180.  
  181.             the essential files:
  182.                winsock.dll      the guts of the TCP/IP driver
  183.                tcpman.exe       interface program  for  managing  the
  184.                                 winsock
  185.                winpkt.com       virtual packet  driver  interface for
  186.                                 windows
  187.                hosts            list of host names & aliases
  188.                services         list of Internet services
  189.                protocol         list of Internet protocols
  190.  
  191.             Modify the path  line in  your autoexec.bat to  contain a
  192.             reference to that directory.
  193.  
  194.               eg. path c:\dos;c:\windows;c:\trumpet
  195.  
  196.             Make  sure  it  is  active  by   rebooting  or  executing
  197.             autoexec.bat again.
  198.  
  199.             The most basic  setup of  packet driver and  WINPKT would
  200.             look something like this example :
  201.  
  202.  
  203.                ne2000 0x60 2 0x300
  204.                WINPKT 0x60
  205.  
  206.  
  207.             The first line installs an NE2000 packet driver on vector
  208.             0x60 using IRQ 2 and I/O address 0x300
  209.  
  210.             The second line installs the WINPKT virtual packet driver
  211.             using the same vector  that the ne2000  packet driver was
  212.             installed on.
  213.  
  214.  
  215.                                         5
  216.  
  217.  
  218.             This is  of course  an example  so your  mileage  will of
  219.             course vary.   Some example configurations  are described
  220.             later in this document.   Choose the one  which suits you
  221.             the best and modify it to your requirements.
  222.  
  223.             Now you are ready to start windows.  Start it up!!
  224.  
  225.             From windows, start up tcpman. From  the file manager, go
  226.             File/Run, and then "tcpman".  If this fails,  the path is
  227.             probably not set up  correctly, so fix it.  Later on, you
  228.             can install it as an icon to use it directly.
  229.  
  230.             Assuming you are a  first time user, a  setup screen will
  231.             appear giving you  a number of  options to fill  in.  You
  232.             will need  to fill  in a  few details  to enable  the TCP
  233.             package to function.   Fill in the  following details. If
  234.             you are unclear  on any  of them, try  to seek  some help
  235.             from qualified Internet support staff -  it will save you
  236.             a lot of time.
  237.  
  238.                IP address       your Internet IP address, "bootp", or
  239.                                 "rarp". lower  case please.    If you
  240.                                 use BOOTP,  be sure  to have  a BOOTP
  241.                                 service on the network or the winsock
  242.                                 will not load.
  243.                Netmask          your  Internet  network   mask.  (eg.
  244.                                 255.255.0.0)
  245.                Default Gateway  your default  Internet  gateway.  (IP
  246.                                 address)
  247.                Name server      your name server  IP address  for DNS
  248.                                 searches.  You may  provide more than
  249.                                 one   address   by   separating   the
  250.                                 addresses with spaces.  (IP addresses
  251.                                 only)
  252.                Time server      at present  unused  - future  winsock
  253.                                 API's may support this. (IP addresses
  254.                                 only)
  255.                Domain suffix    a  space  separated  list  of  domain
  256.                                 suffixes to  be  used when  resolving
  257.                                 names in the DNS system.
  258.                Packet Vector    either leave this as 00 to search for
  259.                                 the packet driver, or the vector that
  260.                                 you  installed   the   packet  driver
  261.                                 under.   The  number  is required  in
  262.                                 hexadecimal without the leading "0x".
  263.                                 In our  example,  you  would  provide
  264.                                 "60".  (numeric)
  265.  
  266.                MTU              Maximum Transmission  Unit. (numeric)
  267.                                 For Ethernet,  1500  is the  maximum,
  268.                                 and is recommended.
  269.                TCP RWIN         TCP  Receive  Window   (numeric)  eg.
  270.                                 (defaults to 4096 but can be larger)
  271.                TCP MSS          TCP Maximum  Segment  Size  (numeric)
  272.                                 (usually MTU - 40)
  273.  
  274.  
  275.                                         6
  276.  
  277.  
  278.             The rest of the details should be greyed out and you need
  279.             not try  to fill  them in.  The Internal  SLIP  check box
  280.             should not be checked.
  281.  
  282.             The first  four  parameters  and  the  packet vector  are
  283.             required for successful functioning of the winsock, while
  284.             the rest can be tailored to suit your needs.
  285.  
  286.             When you are  done, click on  <OK> and if  all goes well,
  287.             the Trumpet  Winsock will  be initialised.   You  are now
  288.             ready to start using the winsock.
  289.  
  290.  
  291.             What to do if something goes wrong
  292.  
  293.             Firstly...
  294.  
  295.             The Trumpet Winsock  requires that your  have the correct
  296.             combination of  tcpman.exe,  winsock.dll and  winpkt.com.
  297.             When upgrading to  a new  release, replace each  of these
  298.             files to be sure that everything is up to date.
  299.  
  300.             If you get the messages about not finding a packet driver
  301.             or unable to load TCP, then  check that the packet driver
  302.             loaded properly, that WINPKT managed to find it, and that
  303.             the correct vector was chosen from tcpman.
  304.  
  305.             At the moment, only Ethernet and SLIP packet driver types
  306.             are supported.
  307.             Token ring  is  only available  via  the ibmtoken  packet
  308.             driver, and should work, but is untested by the author.
  309.  
  310.             ODI can be  used via  the ODIPKT shim,  and NDIS  via the
  311.             DIS_PKT shim.   examples  are provided  later on.   Also,
  312.             examples are provided of installation using NetWare.
  313.  
  314.             Possible causes for tcpman load errors specific to packet
  315.             drivers.
  316.  
  317.                unable to bind protocol 0806    another TCP  stack  is
  318.                                           using the  packet driver...
  319.                                           remove it.
  320.                WINPKT or pktdrv not found couldn't find  the  correct
  321.                                           packet driver.   Also check
  322.                                           the   vector    number   in
  323.                                           TCPMAN.
  324.                unable to allocate network buffers   critical error...
  325.                                           try to free up some special
  326.                                           driver memory  by  removing
  327.                                           windows device drivers.
  328.                network buffers low        not      critical       but
  329.                                           unadvisable... see above
  330.  
  331.             If WINPKT can't load (No packet driver found), check your
  332.             packet driver vector number.   Some drivers  may choose a
  333.             default vector which is not at  0x60. eg.  ODIPKT default
  334.             is 0x69
  335.  
  336.  
  337.                                         7
  338.  
  339.  
  340.             If you are using  ODIPKT and you can't  get any response,
  341.             you probably accessing the  wrong protocol.   If you have
  342.             the ARP trace on,  you will possibly get  "ARP timed out"
  343.             messages as well.  The first  parameter of ODIPKT selects
  344.             the correct protocol. Try adjusting this.
  345.  
  346.             Anything else...   contact me.   I'll  try to  figure out
  347.             what's wrong, but first browse the samples provided.
  348.  
  349.  
  350.                                         8
  351.  
  352.  
  353.  
  354.             Installing Trumpet Winsock over Internal SLIP
  355.  
  356.             SLIP is a  simple protocol  which allows an  Async serial
  357.             connection to send  Internet Protocol (IP).   You usually
  358.             need to  have access  to  a server  which  can understand
  359.             SLIP.  Usually,  SLIP is accessed  via a phone  line, and
  360.             with the advent of high speed modems, TCP/IP is a reality
  361.             over a dial-up connection.
  362.  
  363.             The Trumpet Winsock  has facilities  for managing  a SLIP
  364.             connection as well as the ability to use dialling scripts
  365.             for logging in and out of your SLIP server.
  366.  
  367.             Actually Installing the Winsock.
  368.  
  369.             Before you  do  anything,  copy  the  files  winsock.dll,
  370.             tcpman.exe, hosts,  services and  protocol to  a suitable
  371.             directory.
  372.  
  373.               eg. c:\trumpet
  374.  
  375.             the essential files:
  376.                winsock.dll      the guts of TCP/IP driver
  377.                tcpman.exe       interface program for  setting up the
  378.                                 winsock
  379.                hosts            list of host names
  380.                services         list of Internet services
  381.                protocol         list of Internet protocols
  382.  
  383.             Modify the path  line in  your autoexec.bat to  contain a
  384.             reference to that
  385.             directory.
  386.  
  387.               eg. path c:\dos;c:\windows;c:\trumpet
  388.  
  389.             Make  sure  it  is  active  by   rebooting  or  executing
  390.             autoexec.bat again.
  391.  
  392.             Now you are ready to start windows.  Start it up!!
  393.  
  394.             From windows, start up tcpman. From  the file manager, go
  395.             File/Run, and then "tcpman".  If this fails,  the path is
  396.             probably not set up  correctly, so fix it.  Later on, you
  397.             can install it as an icon to use it directly.
  398.  
  399.             Assuming you are a  first time user, a  setup screen will
  400.             appear giving you  a number of  options to fill  in.  You
  401.             will need  to fill  in a  few details  to enable  the TCP
  402.             package to function.   Fill in the  following details. If
  403.             you are unclear  on any  of them, try  to seek  some help
  404.             from qualified Internet support staff -  it will save you
  405.             a lot of time.
  406.  
  407.             Firstly, click on Internal SLIP.   Some of the parameters
  408.             will be greyed and others ungreyed.
  409.  
  410.  
  411.                                         9
  412.  
  413.  
  414.                IP address       your Internet IP  address or "bootp".
  415.                                 lower case  only. Only  use  BOOTP if
  416.                                 you are not  intending to use  a dial
  417.                                 in script.  If using a dialler script
  418.                                 with the  address  extracted  by  the
  419.                                 script, or BOOTP later, just leave it
  420.                                 with default value  of 0.0.0.0   Only
  421.                                 use BOOTP if your server supports it,
  422.                                 otherwise the winsock  will delay for
  423.                                 about  15  seconds  and  the  message
  424.                                 "Unable to load TCP" will come up.
  425.                Name server      your name server  IP address  for DNS
  426.                                 searches.  You may  provide more than
  427.                                 one   address   by   separating   the
  428.                                 addresses with spaces.  (IP addresses
  429.                                 only).
  430.                Time server      at present  unused  - future  winsock
  431.                                 API's may support this. (IP addresses
  432.                                 only).
  433.                Domain suffix    a  space  separated  list  of  domain
  434.                                 suffixes to  be  used when  resolving
  435.                                 names in the DNS system.
  436.                MTU              Maximum Transmission Unit. Related to
  437.                                 TCP MSS...  usually  TCP  MSS  +  40.
  438.                                 (Numeric)
  439.                TCP RWIN         TCP Receive Window. It is recommended
  440.                                 that this  value  be roughly  3  to 4
  441.                                 times the value of TCP MSS. (Numeric)
  442.                TCP MSS          TCP  Maximum  Segment   Size,  It  is
  443.                                 recommended that  this be  a smallish
  444.                                 value when using SLIP - say 512 bytes
  445.                                 for SLIP and  lower for  CSLIP. CSLIP
  446.                                 is  able   to   compress  data   more
  447.                                 efficiently when it is less than 255.
  448.                                 (numeric)
  449.                SLIP port        your  comms  port   number  ..1=com1,
  450.                                 2=com2 etc. (numeric)
  451.                baud rate        the  speed  you   wish  to   run  at.
  452.                                 (numeric)
  453.                hardware handshake    recommended   if    your    link
  454.                                 supports it.
  455.                Van Jacobson CSLIP
  456.                Compression      if your server  will support  it. You
  457.                                 may also  have to  adjust MTU,  MSS &
  458.                                 RWIN. to be suitable.
  459.                Online Status
  460.                Detection        if your modem will support it, select
  461.                                 DCD or DSR on-line status detection.
  462.  
  463.  
  464.             The rest of the details should be greyed out and you need
  465.             not try to fill them in.
  466.  
  467.             When you are  done, click on  <OK> and if  all goes well,
  468.             the Trumpet  Winsock will  be initialised.   You  are now
  469.             ready to start using the winsock.
  470.  
  471.             Logging in to the server.
  472.  
  473.  
  474.                                         10
  475.  
  476.  
  477.  
  478.             You can  use either  the  manual login  or  the automatic
  479.             scripting to  access your  server.   For the  time being,
  480.             choose  manual  and   log  into  your   server  with  the
  481.             appropriate commands.  Don't forget to  use the <esc> key
  482.             to get out  when you  have finished  dialling in.   After
  483.             logging in, you may need to go and set your IP address if
  484.             it is allocated dynamically.
  485.  
  486.             If you wish to use another terminal program to dial in to
  487.             the server, don't forget  to issue AT&D0,  or disable DTR
  488.             dropping when exiting the program, or the connection will
  489.             be severed when the application closes the comms port.
  490.  
  491.             Try out pingw to a well  known host IP address  to see if
  492.             all is well.
  493.  
  494.             Problems
  495.  
  496.             Check your baud rates...
  497.             If using hardware  hand shaking  with an  external modem,
  498.             make sure the cable is correctly wired.
  499.             At the moment, all  dialling must be done  with 8bits, no
  500.             parity.  This may not work for you...  you will then need
  501.             to use an external dialler.   The next revision will have
  502.             an extension to the dialler to allow this.
  503.  
  504.             If all else fails... contact me !!
  505.  
  506.             Once you have determined your login sequence, you can set
  507.             up a login  script.   A sample  script is  provided along
  508.             with a listing of a typical session.
  509.  
  510.             Automatic dialling.
  511.  
  512.             Minimal scripting is  supported, and the  script commands
  513.             are
  514.  
  515.                input <timeout> <string>   wait for string received.
  516.                output <string>            send string.
  517.                display <string>           display string on display.
  518.                wait <timeout> { DSR | CTS | RLSD | DCD}
  519.                                           wait  for  DSR  or  CTS  or
  520.                                           RLSD(DCD)
  521.                trace ( on | off )         useful    for     debugging
  522.                                           scripts
  523.                echo (on | off)            defaults to on
  524.                password <prompt>          message box for password
  525.                username <prompt>          message box for username
  526.                address <timeout>          parse IP address
  527.                set (DTR | RTS) (on | off) set/reset the modem lines.
  528.                sleep <seconds>            pause for so many seconds.
  529.                exec <string>              program will be  started up
  530.                                           concurrently          using
  531.                                           winexec().
  532.                online                     enter SLIP mode.   commands
  533.                                           depending    on    received
  534.                                           characters  will  not  work
  535.  
  536.  
  537.                                         11
  538.  
  539.  
  540.                                           correctly    after     this
  541.                                           command is issued since the
  542.                                           winsock will interpret data
  543.                                           as  SLIP  frames.    Useful
  544.                                           before  an   exec   command
  545.                                           which uses the winsock.
  546.                BOOTP                      inform the  winsock  that a
  547.                                           BOOTP  will   be   required
  548.                                           after   the    script   has
  549.                                           finished.
  550.  
  551.                # means start comment except inside string
  552.  
  553.             string arguments
  554.             \l   line feed
  555.             \r   return
  556.             \n   cr/lf pair
  557.             \f   form feed
  558.             \t   tab
  559.             \b   backspace
  560.             \nnn ASCII value in decimal
  561.             \i   IP address
  562.             \p   password
  563.             \u   username
  564.             \c   comm port number  (as you have configured it)
  565.  
  566.             a sample script is  given for logging in  to our Xylogics
  567.             terminal server.
  568.  
  569.                  output atz\13
  570.                  input 10 OK\n
  571.                  #output atd242284\13
  572.                  output atd241644\13
  573.                  input 30 CONNECT
  574.                  input 30 \n
  575.                  wait 30 dsr
  576.                  output \13
  577.                  input 30 username:
  578.                  output tattam\13
  579.                  input 30 password:
  580.                  password Enter your password
  581.                  output \p\13
  582.                  input 30 >
  583.                  output who\13
  584.                  input 30 >
  585.                  output slip\13
  586.                  input 30 Your address is
  587.                  address 30
  588.                  input 30 \n
  589.                  display \n
  590.                  display Connected.  Your IP address is \i.\n
  591.                  exec pingw 131.217.10.1
  592.  
  593.  
  594.             Here's a  log  of a  typical  session.   Names  have been
  595.             blanked out for security.
  596.  
  597.                  Trumpet Winsock Version 1.00 Alpha #18
  598.  
  599.  
  600.                                         12
  601.  
  602.  
  603.                  Copyright (c) 1993 by Peter R. Tattam
  604.                  All Rights Reserved.
  605.                  SLIP ENABLED
  606.                  Internal SLIP driver COM3 Baud rate = 38400 Hardware
  607.                  handshaking
  608.                  My ip = 131.217.8.4 netmask = 255.255.0.0 gateway =
  609.                  131.217.250.1
  610.                  Executing script c:\dev\tcpip\winsock\login.cmd
  611.                  SLIP DISABLED
  612.                  atz
  613.                  OK
  614.                  atd241644
  615.                  CONNECT 38400
  616.  
  617.  
  618.                  Annex Command Line Interpreter   *   Copyright 1991
  619.                  Xylogics, Inc.
  620.  
  621.                  Checking authorization, Please wait...
  622.                  Annex username: xxxxxx
  623.                  Annex password:
  624.  
  625.                  Permission granted
  626.                  University of Tasmania
  627.                  AARNet Terminal Server
  628.  
  629.                  SLIP users:
  630.                  Use a maximum segment size (MSS) of 209
  631.                  and a maximum transmission unit (MTU) of 255.
  632.  
  633.                  Async AppleTalk users:
  634.                  Configure MacTCP to use the Computing Centre zone.
  635.                          *** Note change in procedures for starting
  636.                  async AppleTalk.
  637.                          *** After typing atalk you will be prompted
  638.                  for your password
  639.                          *** again.
  640.                  AARNET TS5 >who
  641.                  Port What User             Location          When
  642.                  Idle  Address
  643.                   2   CLI  xxxxxxxx         ---               8:01pm
  644.                  [local]
  645.                        +1    'telnet tasman.cc'
  646.                   3   CLI  xxxxxxxx         ---               8:15pm
  647.                  [local]
  648.                        +1    'rlogin franklin.cc'
  649.                   4   SLIP modem4           ---               8:19pm
  650.                  ants
  651.                   5   CLI  xxxxxxxx         ---               8:34pm
  652.                  [local]
  653.                   6   CLI  xxxxxxxx         ---               7:19pm
  654.                  [local]
  655.                        +1    'rlogin baudin.cc'
  656.                   17  SLIP modem18          ---               6:39pm
  657.                  ants
  658.                  AARNET TS5 >slip
  659.  
  660.                  Switching to SLIP.
  661.  
  662.  
  663.                                         13
  664.  
  665.  
  666.                  Annex address is 131.217.250.10.  Your address is
  667.                  131.217.8.5.
  668.  
  669.                  Connected.  Your IP address is 131.217.8.5.
  670.  
  671.                  Script completed
  672.                  SLIP ENABLED
  673.  
  674.             Dialler problems.
  675.  
  676.             Q. tcpman just  pauses when  starting up, then  gives the
  677.             message "unable to load TCP".
  678.  
  679.             A. You've probably got BOOTP set.   Replace it by 0.0.0.0
  680.             before dialling and try again. RARP is impossible to send
  681.             via SLIP so don't bother with that.
  682.  
  683.             Q. The  connection appears  to  be too  slow  compared to
  684.             Xmodem.
  685.  
  686.             A.  Possibly the  MTU/MSS & RWIN settings  are not right.
  687.             Try to make  RWIN about  3 to  4 times  MSS and  an exact
  688.             multiple if possible.   Turn  on the IP  trace to  see if
  689.             fragmentation is occurring  on TCP  connections.   If so,
  690.             then reduce MSS until  it stops.  UDP  packets will still
  691.             be fragmented, but  nothing can be  done about that.   On
  692.             the trace, TCP is type 6 while UDP is type 17.
  693.  
  694.             Q.  Some input commands in the script don't work.
  695.  
  696.             A. Check for upper case/lower case conflicts.  Also check
  697.             for blanks at the end of the lines.
  698.  
  699.  
  700.             For other problems, contact me at
  701.  
  702.             trumpet-bugs@petros.psychol.utas.edu.au, or  subscribe to
  703.             the Trumpet  discussion  group  and  ask  your  question.
  704.             Details are at  the end of  this document.   As time goes
  705.             on, various FAQ's  will be  constructed to cope  with the
  706.             more common problems.
  707.  
  708.  
  709.                                         14
  710.  
  711.  
  712.             Sample Configurations for Packet Driver.
  713.  
  714.             1. Plain ne2000 packet driver using WINPKT.
  715.  
  716.                  ne2000 0x60 2 0x300
  717.                  WINPKT 0x60
  718.  
  719.             2. Ne2000 packet driver with Novell  NetWare access using
  720.             WINPKT.
  721.             Important is the  specification of  the -n switch  of the
  722.             packet driver.   Some packet  drivers don't  support this
  723.             switch.   In that  case, you  may  be forced  to  use ODI
  724.             instead. An example could be the Xircom Pocket Adapter.
  725.  
  726.                  ne2000 -n 0x60 2 0x300
  727.                  WINPKT 0x60
  728.                  pdipx
  729.                  netx
  730.                  path c:\dos;c:\network\win31
  731.                  f:
  732.                  login
  733.  
  734.  
  735.             3. Ne2000 packet driver with Novell  NetWare access using
  736.             PKTMUX.  Notice that WINPKT is  not required since PKTMUX
  737.             does a similar job.
  738.  
  739.                  ne2000 -n 0x60 2 0x300
  740.                  pktmux 4
  741.                  pktdrv
  742.                  pktdrv
  743.                  pktdrv
  744.                  pktdrv
  745.                  pdipx
  746.                  netx
  747.                  path c:\dos;c:\network\win31
  748.                  f:
  749.                  login
  750.  
  751.             4. ODI setup with NetWare access.
  752.  
  753.             You will need ODIPKT.  The latest known release is 2.4 It
  754.             is important that  ODIPKT reference the  correct protocol
  755.             for IP  access.  This  can  be  specified  as  the  first
  756.             parameter to ODIPKT (0=1st, 1=2nd and so forth)
  757.  
  758.             Here's a sample of my network attach batch file.
  759.  
  760.                  @echo off
  761.                  cd \
  762.                  lh lsl
  763.                  lh \odi\ne2000
  764.                  cd \net
  765.                  lh ipxodi
  766.                  lh odipkt
  767.                  lh WINPKT 0x69
  768.                  lh netx
  769.                  path c:\dos;c:\net\win31
  770.  
  771.  
  772.                                         15
  773.  
  774.  
  775.                  f:
  776.                  echo on
  777.                  login
  778.  
  779.             Also, your net.cfg must be suitably configured.  Here are
  780.             the relevant excerpts from my net.cfg
  781.  
  782.                  Link Support
  783.                           Buffers 8 1586
  784.                           MemPool 16384
  785.  
  786.                  Link Driver NE2000
  787.                           Port #1 300 20
  788.                           Int #1 2
  789.                           Frame Ethernet_II
  790.                           Frame Ethernet_802.3
  791.                           Protocol IPX 0 Ethernet_802.3
  792.  
  793.  
  794.             The ordering of the frame protocols  is important for the
  795.             default setup  of ODIPKT.   Also,  users should  be aware
  796.             that there  are two  versions of  ODIPKT, one  released I
  797.             believe by FTP  Software, and the  public domain one.   I
  798.             refer to the public domain version.  Also note that there
  799.             are two programs with the same name of "ne2000.com".  One
  800.             is a  packet  driver and  is  referred to  in  an earlier
  801.             section.  The one referred to in this section is actually
  802.             an ODI driver  and won't function  as a packet  driver at
  803.             all.
  804.  
  805.             5. NDIS  &  Windows for  Workgroups  setup. (courtesy  of
  806.             Peter Whisker, WhiskerP@LGWCT.LOGICA.COM)
  807.  
  808.             Installation  of  Trumpet   Winsock  makes  use   of  the
  809.             DIS_PKT9.DOS or DIS_PKT.DOS shims which  provide a Packet
  810.             Driver interface the NDIS.  The  version I have tested is
  811.             found on a number of sites  as DISPKT11.ZIP, and contains
  812.             DIS_PKT.DOS dated 28/4/93.  The example is  based upon an
  813.             actual configuration  using  DEC  Pathworks  version  4.1
  814.             (DECNET version)  with  a  DEPCA  Ethernet  card.    This
  815.             installation assumes that  you have  NDIS up  and running
  816.             and have a valid PROTOCOL.INI file.
  817.  
  818.             You need to perform three basic steps:
  819.                Load the  DIS_PKT driver  in CONFIG.SYS  following  the
  820.                load of PROTMAN.SYS:
  821.  
  822.                  DEVICEHIGH=\DECNET\PROTMAN.SYS /I:C:\DECNET
  823.                  DEVICEHIGH=\DECNET\DEPCA.DOS
  824.                  DEVICEHIGH=\DECNET\DIS_PKT.DOS
  825.  
  826.                Add  a  few  lines   to  PROTOCOL.INI  (here   labelled
  827.                [PKTDRV]) in order to bind  it to the Ethernet  driver.
  828.                In this example, DIS_PKT.DOS  is configured with packet
  829.                vector 60.
  830.  
  831.                  [DEPCA.DOS]
  832.                  DRIVERNAME = DEPCA$
  833.  
  834.  
  835.                                         16
  836.  
  837.  
  838.                  .
  839.                  .
  840.                  .
  841.                  [PKTDRV]
  842.                    DRIVERNAME = PKTDRV
  843.                    BINDINGS = DEPCA.DOS
  844.                    INTVEC = 0x60
  845.  
  846.                In AUTOEXEC.BAT, load WINPKT or PKTMUX as  described in
  847.                examples 2 and 3 above.  This should be done  after the
  848.                NETBIND command in your NDIS startup has been executed.
  849.                In the  case of  Pathworks,  this command  is  normally
  850.                contained in STARTNET.BAT. For example:
  851.  
  852.                  call \decnet\startnet.bat
  853.                  WINPKT 0x60
  854.  
  855.  
  856.             6.   Some more  packet driver  installations  courtesy of
  857.             Ashok Aiyar (ashok@biochemistry.bioc.crwu.edu)
  858.  
  859.             Configuration for  Cabletron Network  Cards.   The packet
  860.             driver provided by Cabletron is a  little confusing as it
  861.             doesn't use  the same  parameters as  packet-drivers that
  862.             use the Crynwr skeleton.
  863.  
  864.             Typically the Cabletron driver is loaded as:
  865.  
  866.             "csipd_e /s:62 /h:7 /p:300"
  867.  
  868.             In this  example the  software interrupt  is 0x62.   Load
  869.             winpkt.com as
  870.  
  871.             "WINPKT 0x62"
  872.  
  873.             Release 11 of the Crynwr packet drivers includes a driver
  874.             for Cabletron  cards  written by  Kai  Getrost using  the
  875.             Crynwr skeleton  that  uses the  same  parameters as  the
  876.             other Crynwr drivers.   This driver  (CTRONDNI.COM) seems
  877.             to work well  with E1020/1040 and  E2020 Cabletron cards.
  878.             Indeed I  see  a  performance  gain  over  the  Cabletron
  879.             driver.  Your mileage may vary.
  880.  
  881.             C/SLIPPER with PKTMUX.  Although the  Trumpet Winsock has
  882.             built in support for C/SLIP, there are situations when in
  883.             addition to Winsock applications  there is a  need to run
  884.             packet driver  applications  simultaneously  over a  SLIP
  885.             link.  For such situations, PKTMUX is of utility.
  886.  
  887.             Example:
  888.  
  889.             CSLIPPER vec=65 com1 irq=04H baud=57600 ether
  890.             PKTMUX 4 65 /4  .... (support for  a maximum of 4 virtual
  891.             packet drivers)
  892.             PKTDRV 60 65
  893.  
  894.             Configure the Trumpet  Winsock to use  the virtual packet
  895.             driver  at  0x60.    All  other  virtual  packet  drivers
  896.  
  897.  
  898.                                         17
  899.  
  900.  
  901.             (PKTDRV) can be loaded  in the DOS Windows  in which they
  902.             are used.    They  need  not  be loaded  before  entering
  903.             Windows.
  904.  
  905.             (Ed. Note... You  may also require  the use of  a special
  906.             comms buffer  to  enhance the  buffering  capabilities of
  907.             Windows when  using slipper/cslipper.   An  FAQ  on doing
  908.             this is  available  from  biochemistry.bioc.cwru.edu  via
  909.             gopher or FTP.  It is not  needed when using the internal
  910.             SLIP functions of the Winsock)
  911.  
  912.             Extra Info
  913.  
  914.             You may use environment variables or command line options
  915.             to override some  of the  network parameters.   They have
  916.             the same names  as the  saved parameters  in trmpwsk.ini.
  917.             This file  normally  resides  in  the  winsock  directory
  918.             rather than the windows directory  since this facilitates
  919.             setting up the  winsock in  a networked environment.   IP
  920.             addresses can  be  overridden  by  using the  environment
  921.             variables, or the command line.
  922.  
  923.             example of command line.
  924.  
  925.                tcpman -ip=123.231.213.123 -netmask=255.255.255.0
  926.  
  927.             example of environment variable
  928.  
  929.               set ip=123.231.213.123
  930.               set netmask=255.255.255.0
  931.  
  932.             Here's a list of parameters.
  933.  
  934.                ip/myip          your IP address or  'bootp' or 'rarp'
  935.                                 (lower case only)
  936.                netmask          your netmask.  eg.  255.255.0.0
  937.                gateway/mygatewayyour gateway (IP address)
  938.                dns              list of DNS IP addresses
  939.                time             list of time server IP addresses
  940.                domain           list of domain name suffixes
  941.                vector           packet driver vector in hex
  942.                MTU              Maximum Transmission Unit
  943.                RWIN             TCP Receive Window.
  944.                MSS              TCP Maximum Segment Size
  945.                slip-enabled     0 = off, 1 = on
  946.                slip-port        port number (1-9)
  947.                slip-baudrate    baud rate in decimal
  948.                slip-handshake   0 = off, 1 = on
  949.                slip-compressed  0 = off, 1 = on
  950.  
  951.             The Crynwr packet driver collection
  952.  
  953.             Availability
  954.  
  955.             The Crynwr packet driver collection is available by mail,
  956.             by FTP, by e-mail, by UUCP and by modem.  The drivers are
  957.             distributed in three files: drivers.zip, which contains
  958.             executables and documentation, drivers1.zip, which
  959.  
  960.  
  961.                                         18
  962.  
  963.  
  964.             contains the first half of the .ASM files, and
  965.             drivers2.zip, which contains the second half of the .ASM
  966.             files.
  967.  
  968.             Mail:
  969.  
  970.             Columbia University distributes packet drivers by mail.
  971.             The formats are 9-track 1600 bpi tapes in ANSI, tar, or
  972.             OS SL format, or PC diskettes (360K 5.25" and 720K 3.5").
  973.             The exact terms and conditions have yet to be worked out,
  974.             please call (212) 854-3703 for ordering information, or
  975.             write to:
  976.  
  977.               Kermit Distribution, Dept PD
  978.               Columbia University Center for Computing Activities
  979.               612 West 115th Street
  980.               New York, NY  10025
  981.  
  982.             or send e-mail to kermit@watsun.cc.columbia.edu
  983.             (Internet) or
  984.             KERMIT@CUVMA (BITNET/EARN).
  985.  
  986.  
  987.             FTP/e-mail:
  988.  
  989.             The packet driver collection has its own directory
  990.             devoted to it, pd1:<msdos.pktdrvr>.  The drivers are
  991.             there, along with many free programs that use the packet
  992.             drivers.
  993.  
  994.             SIMTEL20 files are also available from mirror sites
  995.             OAK.Oakland.Edu
  996.             (141.210.10.117), wuarchive.wustl.edu (128.252.135.4),
  997.             ftp.uu.net (192.48.96.9), nic.funet.fi (128.214.6.100),
  998.             src.doc.ic.ac.uk (146.169.3.7) or rana.cc.deakin.oz.au
  999.             (128.184.1.4), or by e-mail through the BITNET/EARN file
  1000.             servers.
  1001.  
  1002.             Modem:
  1003.  
  1004.             If you cannot access them via FTP or e-mail, most
  1005.             SIMTEL20 MSDOS files, including the PC-Blue collection,
  1006.             are also available for downloading from Detroit Download
  1007.             Central (313) 885-3956.  DDC has multiple lines which
  1008.             support 300/1200/2400/9600/14400 bps
  1009.             (103/212/V22bis/HST/V32bis/V42bis/MNP).  This is a
  1010.             subscription system with an average hourly cost of 17
  1011.             cents.  It is also accessable on Telenet via PC Pursuit
  1012.             and on Tymnet via StarLink outdial.  New files uploaded
  1013.             to SIMTEL20 are usually available on DDC within 24 hours.
  1014.  
  1015.             CD-ROM:
  1016.  
  1017.             Public, private or corporate institutions and libraries
  1018.             interested in the SIMTEL20 MSDOS collection in CD-ROM
  1019.             format bundled with library card-catalog type access and
  1020.             duplication software can contact Coyote Data, Ltd. by
  1021.  
  1022.  
  1023.                                         19
  1024.  
  1025.  
  1026.             mail at 1142 N. Main, Rochester, MI 48307 or by FAX at
  1027.             (313) 651-4071.
  1028.  
  1029.             UUCP:
  1030.  
  1031.             The packet driver files are available from UUNET's 1-900-
  1032.             GOT-SRCS, in uunet!~/systems/msdos/simtel20/pktdrvr.  See
  1033.             UUNET.DOC for details.
  1034.  
  1035.             ODIPKT location
  1036.  
  1037.             I am told  that the  originating site  for ODIPKT  is the
  1038.             following...
  1039.  
  1040.             Host hsdndev.harvard.edu
  1041.  
  1042.                  Location: /pub/odipkt
  1043.                         FILE -rwxr-xr-x           2915  Aug  21 20:01
  1044.             odipkt.com
  1045.  
  1046.             A copy of the NDIS shim is there also.
  1047.  
  1048.  
  1049.                                         20
  1050.  
  1051.  
  1052.  
  1053.             Trumpet General Discussion Group.
  1054.  
  1055.             The machine petros.psychol.utas.edu.au  is now  running a
  1056.             local news service with the news groups
  1057.  
  1058.                  trumpet.announce
  1059.                  trumpet.bugs
  1060.                  trumpet.feedback
  1061.             &    trumpet.questions
  1062.  
  1063.             If you do not have access directly to this service, these
  1064.             news groups are gatewayed to the following mailing list.
  1065.  
  1066.             You may join  the new Trumpet  mailing list by  sending a
  1067.             message to
  1068.  
  1069.                  listproc@petros.psychol.utas.edu.au
  1070.  
  1071.             with just one line in the body.
  1072.  
  1073.                  subscribe trumpet-user Your Full Name
  1074.  
  1075.             Where "Your Full Name" should be  replaced by your actual
  1076.             full name.
  1077.  
  1078.             The list is called
  1079.  
  1080.                  trumpet-user@petros.psychol.utas.edu.au
  1081.  
  1082.  
  1083.             and is running on a 486/50 FreeBSD system.  Hopefully it
  1084.             will cope ;-)
  1085.  
  1086.             You can  ask  questions, or  discuss  any  aspect of  any
  1087.             Trumpet program  on  this  group.    Feedback  is  always
  1088.             welcome.  There  is also an  anonymous FTP area  with all
  1089.             the latest Trumpet programs and pre-releases.   If you do
  1090.             use a  pre-release, be  prepared for  unexpected problems
  1091.             since such programs are in alpha/beta test.
  1092.  
  1093.  
  1094.             Bugs or Comments
  1095.  
  1096.             Send to
  1097.  
  1098.                trumpet-bugs@petros.psychol.utas.edu.au
  1099.  
  1100.             For bug  reports,  please  send  a  copy  of  config.sys,
  1101.             autoexec.bat,  trumpwsk.ini,   and  any   other  relevant
  1102.             network configurations.   In the  case of ODI,  also send
  1103.             net.cfg.  We  will do my  best to sort  out your problem.
  1104.             Due to the high  demand for the Trumpet  Winsock, my mail
  1105.             box can be overloaded  at times.  Be  patient...  someone
  1106.             will answer you.
  1107.  
  1108.  
  1109.                                         21
  1110.  
  1111.  
  1112.             TCPMAN - The Trumpet Winsock TCP Manager
  1113.  
  1114.             Menu options.
  1115.  
  1116.             File/Setup          calls  up   the   setup  dialog   for
  1117.             configuration
  1118.  
  1119.                  IP address          your  IP  address,   "bootp"  or
  1120.                                      "rarp" (lower case).
  1121.                                      BOOTP will only work if there is
  1122.                                      a BOOTP service on-line.
  1123.                                      RARP will  only  work  if  using
  1124.                                      Ethernet, and  there is  an RARP
  1125.                                      service on-line.
  1126.                  Netmask             your network mask.
  1127.                  Default gateway     your default Internet gateway or
  1128.                                      router.
  1129.                  Name server         your Domain Name Server address.
  1130.                  Time server         (unused leave empty)
  1131.                  Domain Suffix       A  space   separated   list   of
  1132.                                      suffixes  to   be   tried   when
  1133.                                      looking up  names  via the  name
  1134.                                      server.
  1135.                  Packet Vector       for accessing the  packet driver
  1136.                                      in hex.
  1137.                  MTU                 Maximum Transmission Unit.
  1138.                  TCP RWIN            TCP Receive Window
  1139.                  TCP MSS             TCP Maximum Segment Size
  1140.  
  1141.                  Demand Load Timeout Number of  seconds  tcpman stays
  1142.                                      loaded after the application has
  1143.                                      finished with it.
  1144.  
  1145.                  Internal SLIP       Click on this  for internal SLIP
  1146.                                      support & dialler support.
  1147.                  SLIP port           which comms port to use.
  1148.                  Baud Rate           speed of the connection.
  1149.                  Hardware Handshaking     turn   on    for    RTS/CTS
  1150.                                      handshaking.  May   require  the
  1151.                                      AT&K3 modem command  to function
  1152.                                      properly.
  1153.                  Van Jacobson CSLIP compression
  1154.                                      turn on  for  CSLIP  TCP  header
  1155.                                      compression.
  1156.  
  1157.                  Online Status Detection  needed     for      dialler
  1158.                                      autologin / autologout enabling.
  1159.                     None             no online status detection
  1160.  
  1161.                     DCD (RLSD) check may require AT&C1  modem command
  1162.                                      to function.
  1163.  
  1164.                     DSR check        may require AT&S1  modem command
  1165.                                      to function.
  1166.  
  1167.  
  1168.                                         22
  1169.  
  1170.  
  1171.             File/Register       calls up the registration dialog.
  1172.             File/Exit           quits the  TCP  manager, forcing  the
  1173.             winsock to be unloaded.
  1174.  
  1175.             Edit/Copy           copy selected text  on tcpman display
  1176.             to the clipboard
  1177.             Edit/Clear          clear the tcpman display
  1178.  
  1179.             Tracing options.   Use with care  since some applications
  1180.             may crash when the  traces are active.   Should a program
  1181.             crash with stack overflow, the winsock  may remain loaded
  1182.             in memory even though tcpman has exited.  It is advisable
  1183.             to restart windows if  this happens and  possibly even to
  1184.             reboot your machine.   Also,  timing measurements  of the
  1185.             winsock throughput will be severely affected by the trace
  1186.             options.
  1187.  
  1188.             Trace/TCP           turn TCP trace on/off
  1189.             Trace/UDP           turn UDP trace on/off
  1190.             Trace/IP            turn IP tracing on/off
  1191.             Trace/ARP           turn ARP tracing on/off
  1192.             Trace/RARP          turn RARP tracing on/off
  1193.             Trace/Ethernet      add Ethernet  headers  to IP/ARP/RARP
  1194.             traces.
  1195.             Trace/Extra detail  add some extra  detail to TCP,  UDP &
  1196.             IP traces.
  1197.             Trace/Socket calls  trace each winsock call.
  1198.                                 most  parameters  are   displayed  as
  1199.             well.
  1200.             Trace/DNS           trace Domain Name Server operations.
  1201.                                 Use with care, stack overflows can be
  1202.             frequent.
  1203.             Trace/Messages      trace Async Socket messages.
  1204.  
  1205.  
  1206.                                         23
  1207.  
  1208.  
  1209.  
  1210.             Dialler/Login       invoke the login.cmd dialler script.
  1211.             Dialler/Bye         invoke the bye.cmd dialler script.
  1212.             Dialler/Other       invoke other scripts.
  1213.                                 a file selection dialog of *.cmd will
  1214.             be
  1215.                                 displayed.
  1216.             Dialler/Options     call up the dialler options dialog.
  1217.  
  1218.                  No automatic login
  1219.                  Automatic login on startup only.
  1220.                  Automatic login and logout on demand.
  1221.  
  1222.                  SLIP inactivity timeout (minutes)  Number of minutes
  1223.                                           to  wait   before   exiting
  1224.                                           winsock.      (when      no
  1225.                                           application  is  using  the
  1226.                                           winsock.)   Automatic login
  1227.                                           & logout  must  be  enabled
  1228.                                           for this to  close the SLIP
  1229.                                           connection.   A value  of 0
  1230.                                           disables the timeout.
  1231.  
  1232.             Dialler/Manual Login     invoke the dialler manually.
  1233.                                 Use <esc>  to  exit  from the  manual
  1234.             dialler.
  1235.             Dialler/Edit Scripts     invokes  notepad  to   edit  any
  1236.             script.
  1237.  
  1238.             Help/About          Display  the   version   number   and
  1239.             copyright.
  1240.  
  1241.  
  1242.                                         24
  1243.  
  1244.  
  1245.             Registration
  1246.  
  1247.  
  1248.             Registration of the  Trumpet Winsock is  encouraged since
  1249.             it funds further development of the winsock.  It involves
  1250.             sending in  a  registration  form  filled  in  with  your
  1251.             registration name and other details.   On receipt of your
  1252.             registration, you  will  receive  a  password which  will
  1253.             remove the  UNREGISTERED  VERSION notice  and  replace it
  1254.             with  your   registration  name.     As   part   of  this
  1255.             registration, you will receive enough support  to get you
  1256.             going within the existing capabilities of  the winsock at
  1257.             the  present  time,  and  preference  will  be  given  to
  1258.             registered users  when it  comes to  bug fixes  or future
  1259.             enhancements  to  the  winsock.    Packet  drivers  using
  1260.             Ethernet  and  SLIP  are  presently  the  only  supported
  1261.             network access.   The winsock  will function  through the
  1262.             use of packet driver shims for  ODI, NDIS and token ring,
  1263.             but the use  of these  is not  supported, neither  is the
  1264.             winsock supported should you be using PKTMUX.
  1265.  
  1266.  
  1267.             The  Trumpet   Winsock   is   currently  distributed   as
  1268.             shareware. You may use the Trumpet Winsock for 30 days to
  1269.             evaluate its usefulness.  If at the  end of that time you
  1270.             are satisfied with the Trumpet Winsock  as a product, you
  1271.             can register it.  The basic registration fee for a single
  1272.             user version  of the  Trumpet Winsock  is US$20.    See a
  1273.             later section for details on multi-user site licenses.
  1274.  
  1275.             Australian users should  contact me  regarding Australian
  1276.             pricing information and availability.
  1277.  
  1278.             Cheques or Postal Orders should be made out to
  1279.  
  1280.                  Trumpet Software International
  1281.  
  1282.             and sent to
  1283.  
  1284.                  Trumpet Software International
  1285.                  GPO Box 1649,
  1286.                  HOBART, TAS AUSTRALIA 7001
  1287.  
  1288.             You should fill out the following  order form and send it
  1289.             along with  your  cheque or  Postal  Order  to the  above
  1290.             address.
  1291.  
  1292.             FAX/Phone International  61-02-487049,    Australia  002-
  1293.             487049
  1294.  
  1295.             Please note that  International mail can  be rather slow,
  1296.             and  it  may  take  up  to   2  months  to  receive  your
  1297.             registration.
  1298.  
  1299.  
  1300.                                         25
  1301.  
  1302.  
  1303.  
  1304.                +----------------------------------------------+
  1305.                |              O R D E R   F O R M             |
  1306.                | for Trumpet Winsock version 1.0 Software     |
  1307.                +----------------------------------------------+
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.             Ship to:                            Bill to:
  1315.  
  1316.             [                                            ]          [
  1317.             ]
  1318.             [                                            ]          [
  1319.             ]
  1320.             [                                            ]          [
  1321.             ]
  1322.             [                                            ]          [
  1323.             ]
  1324.             [                                            ]          [
  1325.             ]
  1326.  
  1327.  
  1328.             Please supply the following items:
  1329.  
  1330.             ---------------------------------------------------------
  1331.             -------------
  1332.  
  1333.             Licence to use Trumpet Winsock 1.0 for [       ] users
  1334.                                                              . .  . .
  1335.             . US$[       ]
  1336.  
  1337.             Tick at least one of the following options.
  1338.             [ ] 5.25" disk with the latest version of Trumpet Winsock
  1339.             + password
  1340.             [ ] 3.5"  disk with the latest version of Trumpet Winsock
  1341.             + password
  1342.             [ ] registration password via post
  1343.             [ ] registration password via e-mail
  1344.  
  1345.             Your  registration  name   (required)  (will   appear  on
  1346.             program)
  1347.  
  1348.             [________________________________________________________
  1349.             ____________]
  1350.  
  1351.             Your e-mail address (optional - print clearly)
  1352.             [________________________________________________________
  1353.             ____________]
  1354.  
  1355.  
  1356.             Date sent  [______________]       Expected delivery  Date
  1357.             [_______________]
  1358.  
  1359.  
  1360.                                         26
  1361.  
  1362.  
  1363.             Site Licenses
  1364.  
  1365.             A  site  license  is  defined  as  being  a  sale  to  an
  1366.             organisation  or  company,  and  may  not  be  resold  or
  1367.             redistributed for profit. It may only be used within that
  1368.             organisation.
  1369.  
  1370.             prices valid until 30-Jun-1994
  1371.  
  1372.                Single User license
  1373.  
  1374.                  1 user           $20 US
  1375.  
  1376.                Multi-user site license
  1377.  
  1378.                Trumpet Winsock  will  be  charged  by  the number  of
  1379.             simultaneous users.
  1380.                The pricing structure for commercial users is thus
  1381.  
  1382.                  1-99 users          $20 US per user
  1383.                  100-499 users  $2000 US + $10 US per additional user
  1384.             over 100
  1385.                  500-999 users  $6000 US + $5 US  per additional user
  1386.             over 500
  1387.                  1000+ users    $8500 US + $2 US  per additional user
  1388.             over 1000
  1389.  
  1390.                  site restriction 10km radius (negotiable)
  1391.  
  1392.                Unlimited Commercial Site License
  1393.  
  1394.                  $10,000 US for first year.
  1395.                  subsequent years, 25% of unlimited  site license fee
  1396.             for that year.
  1397.                  site restriction 100km radius (negotiable)
  1398.  
  1399.                The pricing structure for educational users is thus
  1400.  
  1401.                  1-100 users         $20 US per user
  1402.                  100+      $2000 US
  1403.  
  1404.                  site restriction unlimited.
  1405.  
  1406.             Your site  license will  give you  support for  up  to 12
  1407.             months from  the date  of  purchase.   Such  support will
  1408.             include upgrades  and  bug fixes  within  that 12  months
  1409.             within  the   constraints  of   the   program's  existing
  1410.             capabilities.    Future  upgrades  will  be  25%  of  the
  1411.             original license fee  per annum.   Arrangements will also
  1412.             be made  for  conversion of  smaller  licenses to  larger
  1413.             ones.
  1414.  
  1415.  
  1416.                                         27
  1417.  
  1418.  
  1419.  
  1420.             Should  you  wish  to  obtain  the   Trumpet  Winsock  to
  1421.             distribute  with  other  programs,  you   should  make  a
  1422.             suitable offer to Trumpet Software  International, and it
  1423.             will be  considered.    Source  code  will  not  be  made
  1424.             available under any  circumstances, and  Trumpet Software
  1425.             International reserves the right not to  accept any offer
  1426.             which is not considered acceptable.
  1427.  
  1428.             Trumpet Software International
  1429.             GPO Box 1649,
  1430.             HOBART, TAS AUSTRALIA 7001
  1431.  
  1432.             FAX/Phone International  61-02-487049,    Australia  002-
  1433.             487049